home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / host3.arc / HOST3.DOC < prev    next >
Text File  |  1989-04-21  |  23KB  |  490 lines

  1.  
  2.  
  3.  
  4.                           H O S T 3 / H 3 U T I L S
  5.  
  6.             This  program is hereby placed into Public  Domain, for  all
  7.        to use freely, and without charge.
  8.  
  9.        HOST3.SLC and H3UTILS.SLC are  SALT language  scripts compiled to
  10.        run under the TELIX.EXE (C) telecommunications program.
  11.  
  12.             This program evolved from the original  HOST.SLC/HCONFIG.SLC
  13.        programs,  and then the later revisions by Jon  Flemming found in
  14.        HOST2.SLC/H2CONFIG.SLC.
  15.  
  16.             HOST3 was written as a sort of pet project of mine, in order
  17.        to enhance the HOST2.SLC program, written by Jon Flemming. I felt
  18.        that although he had made some superb changes to Colin's original
  19.        HOST.SLC,  there was SO much more that  could be done to make the
  20.        program  even better.    So, I began working on it.   And this is
  21.        what I have come up with so far...hope you enjoy it!
  22.  
  23.             These are the files needed to run the HOST3 program. Some of
  24.        these will be created as needed, as well some of them are  purely
  25.        optional:
  26.  
  27.                 HOST3.SLC - Main  Host Mode  file, must be in your telix
  28.                             script directory.
  29.  
  30.                 H3UTILS.SLC - Utilities script, it  contains all of  the
  31.                               utilites.   It is called by the  HOST3.SLC
  32.                               program.   It should also be in your telix
  33.                               script directory.  Do not try to run  this
  34.                               by itself!
  35.  
  36.                 GATEWAY2.SYS - This is the program that controls the i/o
  37.                                during the time a user shell's to DOS, as
  38.                                well as when they view an archive.   This
  39.                                file should be in your root directory.
  40.                                (see "INSTALLATION"  and the GATEWAY2.DOC
  41.                                file included, on exact installation)
  42.  
  43.                 HOST3.CNF - This is the configuration file created after
  44.                             the configuration  program has been run.  It
  45.                             will be created in your telix directory.
  46.  
  47.                 USER.DAT - This is the data file that holds all the user
  48.                            information, it is created by  HOST3.SLC.  It
  49.                            will be created in your telix directory.
  50.  
  51.                 HOST3.LOG - This file is created by the HOST3.SLC, it is
  52.                             a log of all user logon's and what each user
  53.                             does when on the system.  It will be created
  54.                             in your telix directory.
  55.  
  56.                 *.MSG - There are four message files that are  optional.
  57.                         these files  need to be in your telix directory,
  58.                         if you are going to have them.   (see  "OPTIONAL
  59.                         EXTERNAL FILES")
  60.  
  61.  
  62.                                   INSTALLATION
  63.  
  64.             This is really a very  easy program to  install.  Below  are
  65.        some step by step instructions on installing it:
  66.  
  67.         1)      Put the HOST3.SLC and H3UTILS.SLC files into your  Telix
  68.                 script directory.  (See Telix docs on setting a  default
  69.                 script directory.)
  70.  
  71.         2)      Put the GATEWAY2.SYS file into your root directory. Edit
  72.                 your CONFIG.SYS file by adding this line:
  73.                         DEVICE = GATEWAY2.SYS -D -[COM PORT]
  74.                 Where  [COM PORT] is the com port your modem is in.  For
  75.                 a modem on com2 you would use this line:
  76.                         DEVICE = GATEWAY2.SYS -D -2
  77.                 Reboot your computer (otherwise the gateway2.sys program
  78.                 will not be installed.)  See the included,  GATEWAY2.DOC
  79.                 file from the author of  GATEWAY2 for  more  information
  80.                 on the GATEWAY2.SYS program.
  81.  
  82.         3)      Run Telix, and then when in Telix run the HOST3  script.
  83.                 (ALT-G, then type in HOST3).  HOST3 will search for  the
  84.                 configuration file, and then  will automatically run the
  85.                 H3UTILS.SLC program.   Input all the variables needed in
  86.                 the program and then choose the "X" (Exit and Save). See
  87.                 the section "H3UTILS ( The Configuration Program )"  for
  88.                 more detail on the configuration of HOST3.
  89.  
  90.  
  91.                        ACCESS LEVELS AND WHAT EACH CAN DO
  92.  
  93.             There are four access level's in this program.  This section
  94.        will discribe what each level can do.
  95.  
  96.        Level 1: This is your basic new user level.  The user can do most
  97.                 of the things available (except for a few things below),
  98.                 but there are a few limits placed on the user.  For one,
  99.                 the user can only download a certain limit per call, (as
  100.                 specified  in the  configuration.  As well they can only
  101.                 download  from the download  directory,  and can NOT use
  102.                 the extract archives command.
  103.  
  104.        Level 2: This user is  the same as the level 1 user, but does not
  105.                 have a download limit, and can use the extract  archives
  106.                 command.
  107.  
  108.        Level 3: This user can not only do all the Level 2 user can,  but
  109.                 can also download files from ANY directory on your disk,
  110.                 they can also  look at the daily  user log, and can do a
  111.                 "Shell to DOS" IF they know the system password.  (Which
  112.                 is defined in the configuration program).
  113.  
  114.        Level 4: Your basic Sysop level.  Currently this level can do the
  115.                 exact same thing as the  Level 3 user with one addition.
  116.                 Having this level gives the user the option of  shutting
  117.                 down the system remotely, I would reserve this level for
  118.                 yourself (the sysop) only,  but if you have a  extremely
  119.                 good friend...well, that's up to you.
  120.  
  121.  
  122.                               LIST OF USERS COMMANDS
  123.  
  124.             This is a  list of all user commands,  and what each can do.
  125.        It is separated into  sections by level's,  each higher level can
  126.        do what the previous can do.
  127.  
  128.                                      Level 1
  129.  
  130.        [U]pload:  Upload files.  Level's 3+ can upload to ANY directory.
  131.                   If the file is a  archive (either ARC/PAK/ZIP) it will
  132.                   be tested.   If it fails the test the  archive will be
  133.                   erased.
  134.  
  135.        [D]ownload:  Download files.  Level 1 can only download specified
  136.                     limit.  Level's 3+ can  download from ANY directory.
  137.  
  138.        [C]hat:  If the sysop is available, this command will ring a bell
  139.                 calling you to chat,  otherwise it will print a  message
  140.                 saying that the sysop isn't available.  If the sysop  is
  141.                 not available a line will show up on the status box that
  142.                 says "WANTS TO CHAT".  (See "Sysop's Keyboard Commands",
  143.                 and "H3UTILS  (The Configuration Program)" sections, for
  144.                 more information on chat).
  145.  
  146.        [X]xpert:  This function allows the user to change his  expertise
  147.                   level, to one of three levels:
  148.                        NOVICE: Gives a menu of commands.
  149.                        INTERMEDIATE: Gives command letter's as  part of
  150.                                      the input line.
  151.                        EXPERT: NO help whatsoever!
  152.  
  153.        [F]iles List:  This  shows the user  what files are  currently in
  154.                       download directory.
  155.  
  156.        [T]ype Text File:  Types a text file out to the screen, pause can
  157.                           be turned  on or off in the user defaults,  as
  158.                           well, hitting  "P"  will pause, and  "S"  will
  159.                           abort the  listing at  any time.   Level's 3 +
  160.                           can type files in ANY directory.
  161.  
  162.        [G]oodbye:  Log's the user off.
  163.  
  164.        [V]iew Archives:  Let's the user view archives.  Level's 3 +  can
  165.                          view archives in ANY directory.
  166.  
  167.        [Y]our Defaults:  Let's the user change their address, city, zip,
  168.                          state, choose a default protocol, and turn  the
  169.                          pause function on or off.
  170.  
  171.                                      Level 2
  172.  
  173.        [E]xtract files from archives:  This let's the user extract files
  174.                                        from a archive, the file is  then
  175.                                        archived (using PKZIP), into  the
  176.                                        temporary arc ( TEMPARC.ZIP ), it
  177.                                        is deleted when the user hangs up
  178.  
  179.                                      Level 3
  180.  
  181.        [S]hell to DOS:  This let's the user shell to DOS. If the user is
  182.                         remote (not keyboard) then they will be prompted
  183.                         for the system  password, if they fail  to enter
  184.                         it they will not be able to shell.
  185.  
  186.        IMPORTANT!!!!:  There is NO current way to check on the status of
  187.                        the carrier.  Due to this fact, if the carrier is
  188.                        lost while a user is in DOS (via remote) then the
  189.                        SYSTEM WILL HANG!.  The only solution if this  is
  190.                        to happen is to reboot the computer.
  191.  
  192.        System [L]og:  This shows the user the daily usage log, hit  "P"
  193.                       to pause, "S" to abort.
  194.  
  195.                                      Level 4
  196.  
  197.        Control-Z:  This let's the user shut down the system. The user is
  198.                    is prompted for the system password, if they fail the
  199.                    program will continue running.
  200.  
  201.  
  202.                             SYSOP'S KEYBOARD COMMANDS
  203.  
  204.             This is a list of the commands  available to the sysop,  not
  205.        all commands are available at all times.
  206.  
  207.                              WHEN NO USER IS ONLINE
  208.  
  209.        F1:  This turns chat on or off, the  line in the status box shows
  210.             the current condition of chat. (If chat is turned off during
  211.             the Chat hours, then the "OFF" will be in red).
  212.             (See "H3UTILS  (The Configuration Program)" for more  detail
  213.             on Chat Hours).
  214.  
  215.        F2:  This brings up the user  editor, note that there  must be at
  216.             least ONE user, otherwise the user editor will NOT work.
  217.             (See "H3UTILS (The User Editor)" for more information on the
  218.             user editor)
  219.  
  220.        C:   This runs the configuration program.
  221.  
  222.        U:   This will run the user compressor  program, this will delete
  223.             any old or deleted users.  NOTE:  There must be at least one
  224.             user in the user file, or the compressor will not run.
  225.  
  226.        HOME: This brings up a box giving all the online commands.
  227.  
  228.        ESC: This will exit the program and go back to Telix.
  229.  
  230.                            WHEN A USER IS ONLINE
  231.  
  232.        F1:  Turn chat on or off (same as above)
  233.  
  234.        F2:  Run user editor (same as above)
  235.  
  236.        F3:  Temporarily lower the users access.
  237.  
  238.        F4:  Temporarily raise the users access.
  239.  
  240.        F9:  Shell to DOS (the user can not see)
  241.  
  242.        F10: Chat with user.
  243.  
  244.        END: Terminate user.
  245.  
  246.        ESC: Exit program to Telix.
  247.  
  248.        HOME: Bring up the help box.
  249.  
  250.  
  251.                                   H3UTILS.SLC
  252.  
  253.                           (The configuration program)
  254.  
  255.             This program will allow you to change some important data in
  256.        the HOST3 program.  This  section will tell what each category is
  257.        for:
  258.  
  259.        Download directory: This is the directory that the users will  be
  260.                            downloading from.  It will be a sub-directory
  261.                            of your Telix directory. If it is not a legal
  262.                            directory (doesn't exist) it will be created.
  263.  
  264.        Upload directory: This is the directory that all uploads will  go
  265.                          into.  It will also be a sub-directory and will
  266.                          created if it does not exist.
  267.  
  268.        Connection: This is how your computer will be connected.  Usually
  269.                    it will be MODEM(unless you plan to run on a network)
  270.  
  271.        System Password: This is the password that is needed to shut down
  272.                         the system, or to shell to DOS.
  273.  
  274.        Archive Directory: This is the directory that your archive utils.
  275.                           are  found in.  It must be a  EXACT  directory
  276.                           or the program will NOT be able to do anything
  277.                           dealing with archives (VIEW/TEST/EXTRACT), the
  278.                           program will support (ARC/PAK/ZIP), but  there
  279.                           must be these files.
  280.  
  281.                           For *.ARC's:
  282.                                 PKPAK.EXE
  283.                                 PKUNPAK.EXE
  284.                           For *.ZIP's
  285.                                 PKZIP.EXE
  286.                                 PKUNZIP.EXE
  287.                           For *.PAK's
  288.                                 PAK.EXE
  289.                           (must have these commands!)
  290.                                 View: "V"
  291.                                 Test: "T"
  292.                                 Extract: "X"
  293.  
  294.        Access limit: This is the limit (in K's!) that a level 1 user can
  295.                      download per call.
  296.  
  297.        Time Chat is to come on: This is the time that you would like the
  298.                                 "Chatting times" to  start at. Chat will
  299.                                 come on (regardless of current setting),
  300.                                 at this time, and  will stay on  (UNLESS
  301.                                 shutoff manually, if done, the "OFF"  in
  302.                                 the status box will turn red), and  will
  303.                                 go off at the off time.
  304.  
  305.         Time Chat is to go off: This is the time that you would like the
  306.                                 "Chatting times" to end at.
  307.  
  308.                 (NOTE: Due to problems with  some logic statements,  the
  309.                        Chatting times can NOT extend over midnight.  You
  310.                        may have chat on until 11:59pm,  and can have  it
  311.                        come on at 12:01am.  As well, it is not  possible
  312.                        to have chat on for more then 12 hours.)
  313.  
  314.  
  315.                                (The User Editor)
  316.  
  317.             This program allows  you to edit the users.  The Arrow  keys
  318.        move you.  Up/Down move the yellow bar to the next/previous area.
  319.        The left/right arrows move you to the next/previous user. As well
  320.        you  may hit the key  corresponding to the  category you wish  to
  321.        edit.  Hitting  RETURN  will edit the category the bar is on, and
  322.        ESC will exit you back to the program.  The categories are pretty
  323.        self explainitory, but the one I should mention is the  USER FLAG
  324.        this one controls the users current status,  "D"  is deleted, and
  325.        the next time you run the compressor, he/she will be removed from
  326.        the  USER.DAT file,  "A"  is active and is the normal status, and
  327.        "B" is the  blacklist flag, this user will NOT be allowed on  the
  328.        system, and he/she will NOT be deleted from the USER.DAT file.
  329.  
  330.        NOTE:  There must  be at least one  user in the user file, or the
  331.               Editor will not run.
  332.  
  333.  
  334.                             (The User file Compressor)
  335.  
  336.             This program will go through the USER.DAT file and will  get
  337.        rid of all user's with the "D" flag, and will check all "A" users
  338.        to see if they have called within 60 days.  If they haven't  they
  339.        will also be erased.
  340.  
  341.        NOTE:  There  must be at  least one user in the user file, or the
  342.               compressor will not run.
  343.  
  344.  
  345.                             OPTIONAL EXTERNAL FILES
  346.  
  347.             There are four files that can be in the Telix directory, the
  348.        files are NOT needed but they will be used if there:
  349.  
  350.                LOGON.MSG:  This file is displayed when a user first logs
  351.                            on.
  352.  
  353.                NEWS.MSG:  This file is displayed after a user has logged
  354.                           on, and  they have  successfully entered their
  355.                           password.
  356.  
  357.                BYEBYE.MSG:  This file is  displayed when the user  quits
  358.                             the BBS.
  359.  
  360.                NEWUSER.MSG:  This file is displayed to all new users.
  361.  
  362.        IMPORTANT!:  The input buffer for these files is set at the level
  363.                     of 255 characters per line.  If your files have more
  364.                     characters per line they will NOT be sent correctly!
  365.  
  366.        NOTE:  For some reason I have been having some problems with some
  367.               ANSI  graphics screens.  I'm not sure exactly why, but  it
  368.               occurs mostly when typing a large animated ANSI picture, I
  369.               hope to have this fixed by the next version. Try different
  370.               line sizes if you have problems (best way is NOT using any
  371.               animation!)
  372.  
  373.  
  374.                                   DISCLAIMER
  375.  
  376.        This program is provided as is, and is to be run at your own risk.
  377.        There is  NO  warranty of any kind or form covering this  program.
  378.        Exis Inc., Colin Sampaleanu, and the author are not in any way, or
  379.        shape, responsible, or liable for any damages of any kind that may
  380.        arise  from the usage of this program, or that of any programs, or
  381.        files associated, or included with it.
  382.  
  383.        TELIX.EXE, SALT, HOST.SLC, and HCONFIG.SLC:  copyright 1986, 1987,
  384.        1988 by Exis Inc., and Colin Sampaleanu.  Used with permission.
  385.  
  386.  
  387.                                     THANKS
  388.  
  389.             There are a few people  to who I would  like to give  special
  390.        thanks to, for their help and cooperation in my endeavor to create
  391.        this program:
  392.  
  393.        Rick Fry:  My "official" beta tester, and more importantly, a good
  394.                   friend and "idea bouncer".  From whom I got more ideas,
  395.                   and dislikes, then anyone else.
  396.                         Thanks alot Rick.  I appreciate it!
  397.  
  398.        Tony Gentile:  My friend and C "teacher"  who taught me the basics
  399.                       of the C language, which  helped a GREAT deal  when
  400.                       working on this program.  Thanks Tony.
  401.  
  402.        Bill Parfitt:  The sysop of Dbored  (619-748-3644),  who gave me a
  403.                       place to put my program at. As well as alot of good
  404.                       encouragement. (and where I originally got my idea)
  405.  
  406.        Hans Kellner:  The creator of GATEWAY2.SYS  (C), special thanks to
  407.                       him since my program wouldn't work half as well, if
  408.                       I didn't use his program!
  409.  
  410.        And finally,
  411.  
  412.        Colin Sampaleanu:
  413.  
  414.                For the extremely  hard work and numerous, uncounted hours
  415.        that he has put into creating TELIX, which is the very BEST (in my
  416.        opinion) telecommunications program package out there!  Without it
  417.        this program wouldn't be around.
  418.  
  419.                 Very special thanks to you Colin!
  420.  
  421.  
  422.                             WHAT'S AHEAD IN THE FUTURE?
  423.  
  424.             I have quite a few ideas in the works for the next version of
  425.        host (HOST4).  Here's some of them:
  426.  
  427.  
  428.                File Database:  A file database, where each file has  it's
  429.                                own comment.  As well the  sysop can  add,
  430.                                and delete files from the  database.  This
  431.                                would also allow users to "SEARCH" for new
  432.                                and or specific, files.
  433.  
  434.                BBS List:  A full working BBS  listing program,  where the
  435.                           users  can add or change any  information about
  436.                           their favorite BBS's.
  437.  
  438.                Online Programs:  A online sysop definable program section
  439.                                  that will be compatible with the PCBoard
  440.                                  door programs.
  441.  
  442.                External Protocols:  Will allow the sysop to add some  (up
  443.                                     to four), external protocols.  (Telix
  444.                                     only has space for four protocols).
  445.  
  446.                DTR Checking:   A way to check the status of the  carrier,
  447.                                while a user is in DOS will  hopefully  be
  448.                                finished by then.
  449.  
  450.             And finally, something that I was  hoping I might be able  to
  451.        get into this version, but wasn't able to,  because of some  major
  452.        flaw's in the  program.  (Couldn't  get it  to interface correctly
  453.        with the main program)
  454.  
  455.                 Message base:  A fully  functional  message base  system,
  456.                                that would  allow users to read/write mail
  457.                                (both private and public).
  458.  
  459.             If you have any  suggestions or  ideas for the  next version,
  460.        or any problems, or, (God forbid), bugs.  You may get a hold of me
  461.        at these locations.
  462.  
  463.                Dbored of San Diego, (619) 748-3644
  464.                Telix Support BBS, (416) 284-0682
  465.                Prodigy (ID# SNRB40A)
  466.                WWIVnet 124@6951
  467.                PCRelay, Communications conference
  468.                PCRelay, Sysop's Conference
  469.                Voice: (619) 487-5165, 4:30pm - 9:00pm PST (Dan Horn)
  470.                Or mail me:
  471.                        Daniel Horn
  472.                        15837 Windrose Way
  473.                        San Diego, CA  92127
  474.  
  475.  
  476.                               OBTAINING SOURCE CODE
  477.  
  478.             Although this program is  free of charge, the source code  to
  479.        it is NOT.  If you wish to  obtain a copy of  the source code send
  480.        $30 (US) dollars to this address.
  481.  
  482.                            Daniel Horn
  483.                            15837 Windrose Way
  484.                            San Diego, CA 92127
  485.  
  486.             I will send you the latest released version  of host, as well
  487.        as the source code, and some technical information about the  file
  488.        format, all on disk.
  489.  
  490.